<!DOCTYPE html>
<html>
<head>
<title>package.json文件</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<style type="text/css">
/* GitHub stylesheet for MarkdownPad (http://markdownpad.com) */
/* Author: Nicolas Hery - http://nicolashery.com */
/* Version: b13fe65ca28d2e568c6ed5d7f06581183df8f2ff */
/* Source: https://github.com/nicolahery/markdownpad-github */

/* RESET
=============================================================================*/

html, body, div, span, applet, object, iframe, h1, h2, h3, h4, h5, h6, p, blockquote, pre, a, abbr, acronym, address, big, cite, code, del, dfn, em, img, ins, kbd, q, s, samp, small, strike, strong, sub, sup, tt, var, b, u, i, center, dl, dt, dd, ol, ul, li, fieldset, form, label, legend, table, caption, tbody, tfoot, thead, tr, th, td, article, aside, canvas, details, embed, figure, figcaption, footer, header, hgroup, menu, nav, output, ruby, section, summary, time, mark, audio, video {
  margin: 0;
  padding: 0;
  border: 0;
}

/* BODY
=============================================================================*/

body {
  font-family: Helvetica, arial, freesans, clean, sans-serif;
  font-size: 14px;
  line-height: 1.6;
  color: #333;
  background-color: #fff;
  padding: 20px;
  max-width: 960px;
  margin: 0 auto;
}

body>*:first-child {
  margin-top: 0 !important;
}

body>*:last-child {
  margin-bottom: 0 !important;
}

/* BLOCKS
=============================================================================*/

p, blockquote, ul, ol, dl, table, pre {
  margin: 15px 0;
}

/* HEADERS
=============================================================================*/

h1, h2, h3, h4, h5, h6 {
  margin: 20px 0 10px;
  padding: 0;
  font-weight: bold;
  -webkit-font-smoothing: antialiased;
}

h1 tt, h1 code, h2 tt, h2 code, h3 tt, h3 code, h4 tt, h4 code, h5 tt, h5 code, h6 tt, h6 code {
  font-size: inherit;
}

h1 {
  font-size: 28px;
  color: #000;
}

h2 {
  font-size: 24px;
  border-bottom: 1px solid #ccc;
  color: #000;
}

h3 {
  font-size: 18px;
}

h4 {
  font-size: 16px;
}

h5 {
  font-size: 14px;
}

h6 {
  color: #777;
  font-size: 14px;
}

body>h2:first-child, body>h1:first-child, body>h1:first-child+h2, body>h3:first-child, body>h4:first-child, body>h5:first-child, body>h6:first-child {
  margin-top: 0;
  padding-top: 0;
}

a:first-child h1, a:first-child h2, a:first-child h3, a:first-child h4, a:first-child h5, a:first-child h6 {
  margin-top: 0;
  padding-top: 0;
}

h1+p, h2+p, h3+p, h4+p, h5+p, h6+p {
  margin-top: 10px;
}

/* LINKS
=============================================================================*/

a {
  color: #4183C4;
  text-decoration: none;
}

a:hover {
  text-decoration: underline;
}

/* LISTS
=============================================================================*/

ul, ol {
  padding-left: 30px;
}

ul li > :first-child, 
ol li > :first-child, 
ul li ul:first-of-type, 
ol li ol:first-of-type, 
ul li ol:first-of-type, 
ol li ul:first-of-type {
  margin-top: 0px;
}

ul ul, ul ol, ol ol, ol ul {
  margin-bottom: 0;
}

dl {
  padding: 0;
}

dl dt {
  font-size: 14px;
  font-weight: bold;
  font-style: italic;
  padding: 0;
  margin: 15px 0 5px;
}

dl dt:first-child {
  padding: 0;
}

dl dt>:first-child {
  margin-top: 0px;
}

dl dt>:last-child {
  margin-bottom: 0px;
}

dl dd {
  margin: 0 0 15px;
  padding: 0 15px;
}

dl dd>:first-child {
  margin-top: 0px;
}

dl dd>:last-child {
  margin-bottom: 0px;
}

/* CODE
=============================================================================*/

pre, code, tt {
  font-size: 12px;
  font-family: Consolas, "Liberation Mono", Courier, monospace;
}

code, tt {
  margin: 0 0px;
  padding: 0px 0px;
  white-space: nowrap;
  border: 1px solid #eaeaea;
  background-color: #f8f8f8;
  border-radius: 3px;
}

pre>code {
  margin: 0;
  padding: 0;
  white-space: pre;
  border: none;
  background: transparent;
}

pre {
  background-color: #f8f8f8;
  border: 1px solid #ccc;
  font-size: 13px;
  line-height: 19px;
  overflow: auto;
  padding: 6px 10px;
  border-radius: 3px;
}

pre code, pre tt {
  background-color: transparent;
  border: none;
}

kbd {
    -moz-border-bottom-colors: none;
    -moz-border-left-colors: none;
    -moz-border-right-colors: none;
    -moz-border-top-colors: none;
    background-color: #DDDDDD;
    background-image: linear-gradient(#F1F1F1, #DDDDDD);
    background-repeat: repeat-x;
    border-color: #DDDDDD #CCCCCC #CCCCCC #DDDDDD;
    border-image: none;
    border-radius: 2px 2px 2px 2px;
    border-style: solid;
    border-width: 1px;
    font-family: "Helvetica Neue",Helvetica,Arial,sans-serif;
    line-height: 10px;
    padding: 1px 4px;
}

/* QUOTES
=============================================================================*/

blockquote {
  border-left: 4px solid #DDD;
  padding: 0 15px;
  color: #777;
}

blockquote>:first-child {
  margin-top: 0px;
}

blockquote>:last-child {
  margin-bottom: 0px;
}

/* HORIZONTAL RULES
=============================================================================*/

hr {
  clear: both;
  margin: 15px 0;
  height: 0px;
  overflow: hidden;
  border: none;
  background: transparent;
  border-bottom: 4px solid #ddd;
  padding: 0;
}

/* TABLES
=============================================================================*/

table th {
  font-weight: bold;
}

table th, table td {
  border: 1px solid #ccc;
  padding: 6px 13px;
}

table tr {
  border-top: 1px solid #ccc;
  background-color: #fff;
}

table tr:nth-child(2n) {
  background-color: #f8f8f8;
}

/* IMAGES
=============================================================================*/

img {
  max-width: 100%
}
</style>
</head>
<body>
<h1>package.json文件</h1>
<h3>1.概述</h3>
<p>每个项目的根目录下面，一般都有一个package.json文件，定义了这个项目所需要的各种模块，以及项目的配置信息（比如名称、版本、许可证等元数据）。npm install命令根据这个配置文件，自动下载所需的模块，将package.json中的模块安装到node-modules文件夹下，也就是配置项目所需的运行和开发环境。</p>
<h4>生成package.json文件</h4>
<p>package.json文件可以手工编写，也可以使用npm init命令自动生成。这个命令采用互动方式，要求用户回答一些问题，然后在当前目录生成一个基本的package.json文件。所有问题之中，只有项目名称（name）和项目版本（version）是必填的，其他都是选填的。有了package.json文件，直接使用npm install命令，就会在当前目录中安装所需要的模块。</p>
<p>如果一个模块不在package.json文件之中，可以单独安装这个模块，并使用相应的参数，将其写入package.json文件之中。</p>
<pre><code>$ npm install express --save
$ npm install express --save-dev
</code></pre>

<blockquote>
<p><strong>package.json里面不能有注释，有会报错</strong></p>
</blockquote>
<h3>2.name</h3>
<p>package.json中最重要的属性是name和version两个属性，这两个属性是必须要有的，否则模块就无法install，这两个属性一起形成了一个npm模块的唯一标识符。模块中内容变更的同时，模块版本也应该一起变化。</p>
<p><strong>name属性就是你的模块名称</strong></p>
<h3>3.version</h3>
<p>项目版本</p>
<h3>4.description</h3>
<p>一个描述，方便别人了解你的模块作用，搜索(npm search)的时候也有用，格式为<strong>字符串</strong>。</p>
<h3>5.keywords</h3>
<p>关键字。方便使用者在 npm search中搜索。格式为<strong>字符串</strong>。</p>
<h3>6.scripts字段</h3>
<p>npm 允许在package.json文件里面，使用scripts字段定义脚本命令。</p>
<pre><code>{
  // ...
  &quot;scripts&quot;: {
    &quot;build&quot;: &quot;node build.js&quot;，
    &quot;preinstall&quot;: &quot;echo here it comes!&quot;
  }
}
</code></pre>

<p>上面代码build命令对应的脚本是node build.js。</p>
<p><strong>命令行下使用npm run命令，就可以执行这段脚本</strong>。</p>
<pre><code>$ npm run build
# 等同于执行
$ node build.js
</code></pre>

<p>这些定义在package.json的命令（scripts）就称为 npm 脚本。它的优点很多。</p>
<p>1.npm 提供的很多辅助功能。</p>
<p>2.用户不需要知道怎么测试你的项目，只要运行npm run test即可。</p>
<p><strong>查看当前项目的所有 npm 脚本命令，可以使用的npm run命令。</strong></p>
<pre><code>$ npm run
</code></pre>

<h3>7.dependencies字段</h3>
<p><strong>dependencies字段指定了项目运行所依赖的模块，格式为对象</strong>。该对象的各个成员，分别由模块名和对应的版本要求组成，表示依赖的模块及其版本范围。</p>
<pre><code>&quot;deependencies&quot;: {
    &quot;browserify&quot;: &quot;~13.0.0&quot;,
    &quot;karma-browserify&quot;: &quot;~5.0.1&quot;
}
</code></pre>

<p>版本格式如下：</p>
<p>1.<strong>指定版本</strong>：比如1.2.2，遵循“大版本.次要版本.小版本”的格式规定，安装时只安装指定版本。</p>
<p>2.<strong>波浪号（~）+指定版本</strong>：比如~1.2.2，表示安装1.2.x的最新版本（不低于1.2.2），但是不安装1.3.x，也就是说<strong>安装时不改变大版本号和次要版本号</strong>。</p>
<p>3.<strong>插入号（^）+指定版</strong>本：比如^1.2.2，表示安装1.x.x的最新版本（不低于1.2.2），但是不安装2.x.x，也就是说<strong>安装时不改变大版本号</strong>。需要注意的是，如果大版本号为0，则插入号的行为与波浪号相同，这是因为此时处于开发阶段，即使是次要版本号变动，也可能带来程序的不兼容。</p>
<p>4.<strong>latest</strong>：安装最新版本。</p>
<h3>8.devDependencies字段</h3>
<p><strong>devDependencies指定项目开发所需要的模块，格式为对象</strong>。该对象的各个成员和dependencies字段的相同。</p>
<h3>9.安装dependencies字段和dependencies字段</h3>
<p>package.json文件可以手工编写，也可以使用npm init命令自动生成。</p>
<pre><code>$ npm init
</code></pre>

<p>这个命令采用互动方式，要求用户回答一些问题，然后在当前目录生成一个基本的package.json文件。所有问题之中，只有项目名称（name）和项目版本（version）是必填的，其他都是选填的。</p>
<p>有了package.json文件，直接使用npm install命令，就会在当前目录中安装所需要的模块。</p>
<pre><code>$ npm install
</code></pre>

<p>如果一个模块不在package.json文件之中，可以使用相应的参数，单独安装这个模块，安装后会自动写入package.json文件之中。</p>
<p><strong>--save参数表示将该模块写入dependencies属性，--save-dev表示将该模块写入devDependencies属性。</strong></p>
<pre><code>$ npm install express --save
$ npm install express --save-dev
</code></pre>

<p>上面代码表示单独安装express模块。</p>
<h3>10.engines 字段</h3>
<p><strong>指明了该项目所需要的node.js版本。也可以指定适用的npm版本</strong></p>
<pre><code> &quot;engines&quot;: {
    &quot;node&quot;: &quot;&gt;= 4.0.0&quot;,
    &quot;npm&quot;: &quot;&gt;= 3.0.0&quot;
  },
</code></pre>

<h3>11.Repository字段</h3>
<p><strong>用于指示源代码存放的位置</strong></p>
<pre><code>&quot;repository&quot; :{
   &quot;type&quot; : &quot;git&quot;,
   &quot;url&quot; : &quot;http://github.com/npm/npm.git&quot;
 }

&quot;repository&quot; :{
   &quot;type&quot; : &quot;svn&quot;,
   &quot;url&quot; : &quot;http://v8.googlecode.com/svn/trunk/&quot;
 }
</code></pre>

<h3>12.browserslist</h3>
<p>众所周知为兼容所有浏览器，有的CSS属性需要对不同的浏览器加上前缀。</p>
<p>Autoprefixer使用Browserlist来确定哪些浏览器版本将得到支持从而添加前缀。格式为数组。</p>
<pre><code> &quot;browserslist&quot;: [
    &quot;&gt; 1%&quot;, //全球有超过1%的人使用的浏览器
    &quot;last 2 versions&quot;, //根据CanIUse.com追踪的最后两个版本的所有浏览器
    &quot;not ie &lt;= 8&quot; // 不支持ie8及以下
  ]
</code></pre>

<h3>13.private</h3>
<p>设为true这个包将不会发布到NPM平台下。</p>

</body>
</html>
<!-- This document was created with MarkdownPad, the Markdown editor for Windows (http://markdownpad.com) -->
